Skip to content

Add reach-me-out to homelab templates#98

Merged
lissy93 merged 2 commits into
lissy93:mainfrom
kartikeychoudhary:add-reach-me-out
Jul 12, 2026
Merged

Add reach-me-out to homelab templates#98
lissy93 merged 2 commits into
lissy93:mainfrom
kartikeychoudhary:add-reach-me-out

Conversation

@kartikeychoudhary

Copy link
Copy Markdown
Contributor

What

Adds reach-me-out — a static, config-driven link-in-bio page — as a new type: 1 entry in sources/local/homelab_templates.json.

Why

It's a zero-dependency, single-container self-hosted app (React + Vite bundled with nginx, ~30 MB image) that fits the homelab category well: one person deploys it, mounts a config.yaml, and gets a personal profile page with tappable links, QR share, and a downloadable vCard.

Details

  • Image: kartikey31choudhary/reach-me-out — multi-arch (linux/amd64, linux/arm64), tags :latest and :v1.0.0
  • Port: container exposes 80; template maps 8080:80/tcp
  • Config override: optional bind-mount of a user-supplied config.yaml to /usr/share/nginx/html/config.yaml:ro — without it, the image ships a neutral "John Doe" default
  • Env vars: none; all customization is via the mounted YAML
  • Logo: SVG hosted on the app repo (raw.githubusercontent.com)

Verification

  • Diff is strictly additive (26 lines, no reordering)
  • Fields follow Schema.json
  • Image is publicly pullable and the tag in the template resolves today

kartikeychoudhary and others added 2 commits April 21, 2026 14:26
Static link-in-bio page (React + Vite, baked YAML config) published as
kartikey31choudhary/reach-me-out on Docker Hub. Single-container (type 1)
running nginx on port 80. Optional config.yaml bind-mount lets users
override name, links, and theme at runtime without rebuilding.

Repo: https://github.com/kartikeychoudhary/Reach-me-out
Image: https://hub.docker.com/r/kartikey31choudhary/reach-me-out
"type": 1,
"volumes": [
{
"bind": "/path/to/config.yaml",

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a heads up - binding individual files (instead of a directory) can cause issues. Since Docker will create a directory if that file doesn't exist, and then when the user later goes to put their actual file in, it'll be a directory.

I only mention this, because I used to use a similar approach in the early days of Dashy, and it caused many many bug reports 😅

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the heads up, that's a great point — I'll make sure to account for this and use a directory-based bind mount in future templates to avoid that issue. Appreciate the review!

@lissy93 lissy93 merged commit 6f5c718 into lissy93:main Jul 12, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants